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Preface 



The X Window System, called X for short, was developed at the 
Massachusetts Institute of Technology (MIT). It lets UNIX® users display 
multiple X applications in windows. These applications run over a network 
or on a user's stand-alone computer. Developers are currently producing 
word processors, spreadsheets, and other productivity applications for X. 
Users of A/UX® software have access to these X applications through the 
Apple® X Window System for A/UX. 

The Apple X Window System for A/UX provides two different X products: 
MacX™ and XI 1. These two products give A/UX users the flexibility to 
create a personalized X environment on their computers. Both products 
are based on MIT's X Window System, Version 11, Release 4. 

This guide is a starting point for users interested in the Apple X Window 
System for A/UX. Read it to 

■ learn about MacX and XI 1 

■ install MacX on A/UX 

■ install XI Ion A/UX 
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About this guide 

Here's what you'll find in this guide: 

■ Chapter 1, "Introduction to X Window System for A/UX," describes what MacX and XI 1 
include and shows you ways to use them on a network. 

■ Chapter 2, "Installing MacX for A/UX," presents step-by-step instructions for installing 
MacX on the A/UX operating system. It describes what you need for installing and using 
MacX, including software, system requirements, and documentation. 

■ Chapter 3, "Installing Xll," gives step-by-step instructions about installing XI 1 on A/UX. 
It describes what you need for installing and using Xll, including software, system 
requirements, and documentation. 

■ The Appendix, "Setting Up a Network Kernel," explains how to use the newconf ig 
command to configure an A/UX kernel with the network support required by MacX 
and Xll. 



Who should read this guide 

You should read this guide if you are 

■ any user who wants to install MacX or XI 1 

■ a beginning X user who wants an introduction to the X Window System, MacX, or Xll 

■ an experienced X user who just wants to know what MacX and Xll include 

If you're new to X, don't worry if you don't immediately become an X "expert." Most of the 
concepts introduced in this guide are described in detail in the user guides included in the 
X Window System for A/UX package. And once you start using the X products, you'll 
understand more about how the X Window System works. 
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How to use this guide 

Depending on what you want to do, read one or more of the following chapters: 

■ If you're installing MacX, read Chapter 2. 

■ If you're installing or updating Xll, read Chapter 3. 

■ If you're installing both MacX and Xll, read Chapters 2 and 3. 



What you should aheady know 

You should know how to perform such Macintosh® actions as pressing the mouse button 
("clicking"), dragging icons, and choosing menu commands. For a review of Macintosh basics, 
see the owner's guide that came with your Macintosh computer. You should also have some 
familiarity with A/UX 2.0 or later versions. For a review of A/UX basics, read the guide 
A/UX Essentials that came with your A/UX Accessory Kit. 



Conventions used in this guide 

A/UX guides follow specific conventions. Words that require special emphasis appear in 
specific fonts or font styles. The following sections describe the conventions used in all 
A/UX guides. 
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Keys and key combinations 

Certain keys on the keyboard have special names. These modifier and character keys, often 
used in combination with other keys, perform various functions. In this guide, the names of 
these keys are in Initial Capital letters followed by SMALL CAPITAL letters. 

The key names are 



Caps Lock Escape 


Shift 


Command Left Arrow 


Tab 


Control Return 


Up Arrow 


Down Arrow Right Arrow 




For example, suppose you enter 




Applee 




instead of 




Apple 





To erase the additional e, you would position the cursor (or insertion point) to the right of the 
word and press the DELETE key once. 

Sometimes you will see two or more names joined by hyphens. The hyphens indicate that you 
use two or more keys together to perform a specific function. For example, 

Press COMMAND-K 

means "Hold down the Command key and press the K key." 



Terminology 

In A/UX guides, a certain term can represent a specific set of actions. For example, the word 
enter indicates that you type an entry and press the RETURN key. The instruction 
Enter is 

means "Type is and press the RETURN key." 

Here is a list of common terms and the corresponding actions you take. 
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Term Action 

Choose Activate a command in a menu. To choose a command from a pull-down 

menu, click once on the menu title while holding down the mouse button, and 
drag down until the command is highlighted. Then release the mouse button. 

Click Press and then immediately release the mouse button. 

Drag Position the pointer on an object, then press and hold down the mouse 

button while moving the mouse. Release the mouse button when the object 
reaches the desired position on the screen. 

Enter Type the letter or letters and press the RETURN key. 

Press Type a single key without pressing the Return key. Or position the pointer 

on an object and hold down the mouse button. 

Select Position the pointer on a selectable object and click the mouse button. 

Type Type an entry without pressing the RETURN key. 



The Courier font 

Throughout A/UX guides, words that you see on the screen or that you must type exactly as 
shown are in the Courier font. 

For example, suppose you see the instruction 

Type date on the command line and press RETURN. 

The word date is in the Courier font to indicate that you must type it. 

Suppose you then read this explanation: 

Once you type date and press RETURN, you'll see something like this: 

Tues Oct 17 17:04:00 PDT 1989 

In this case. Courier is used to represent exactly what appears on the screen. 

All A/UX manual page names are also shown in the Courier font. For example, the entry is(l) 
indicates that is is the name of a manual page. 
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Font styles 

Words that you must replace with a value appropriate to a particular set of circumstances 
appear in italics. For example, if you see 
cat filename 

replace the italicized word with the name of the file you wish to view. If you want to view 
the contents of a file named Elvis, type the word Elvis in place of filename. In other 
words, enter 

cat Elvis 

New terms appear in boldface where they are defined. 



A/UX command syntax 

A/UX commands follow a specific command syntax. A typical A/UX command has this form: 
command [flag-option] [argument]... 

The following table outlines the elements of an A/UX command. 

Element Description 

command The command name. 

flag-option One or more optional arguments that modify the command. Most flag 

options have the form [-opt...], where opt is a letter representing an option. 

Most commands have one or more flag options. 
argument A modification or specification of a command, usually a filename or 

symbols representing one or more filenames. 
[] Brackets used to enclose an optional item — that is, an item that is not 

essential for execution of the command. 

Ellipses used to indicate an argument that can be repeated any number 

of times. 

For example, the wc command is used to count lines, words, and characters in a file. Here 
is the full syntax for that command, including all possible flag options and the optional 
argument name. 
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wc [-c] [-1] [-w] [name..] 

Thus, you can enter 

wc -w /Priscilla 

to count all of the words in the file /Prisciiia, where wc is the name of the command, -w is 
the flag option that instructs the command to count all of the words in the file, and the 
optional argument /Prisciiia is the file to be searched. 



Command reference notation 

A/UX Command Reference, A/UX Programmer's Reference, and A/UX System Administrator's 
Reference contain references for commands, programs, and other related information. Material 
is organized within these references by section numbers. The standard A/UX cross-reference 
notation is 

cmd (sect) 

where cmd is the name of the command, file, or other facility; sect is the section number where 
the entry resides. 

■ Items followed by section numbers (IM), (7), and (8) are listed in 
A/UX System Administrator's Reference 

m Items followed by section numbers (1), (IC), (IG), (IN), and (6) are listed in 
A/UX Command Reference. 

■ Items followed by section numbers (2), (3), (4), and (5) are listed in 
A/UX Programmer's Reference. 

■ Items followed by section number (IX) are listed in XU Command Reference for A/UX. 

m Items followed by section numbers (3X) and (3Xt) are listed in 
Xll Programmer's Reference for A/UX. 

For example, 

cat(l) 

refers to the command cat, which is described in Section 1 o[ A/UX Command Reference. 
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References can be also called up on the screen. Use the man command to display pages 
from reference manuals, known as manual pages, directly on the screen. For example, enter 
the command 

man cat 

to display the manual page for the cat command, including its description, syntax, options, 
and other pertinent information. To exit, press the Space bar until you see a shell prompt, or 
type q at any time to return immediately to your shell prompt. 

Cross-referencing 

An A/UX guide often refers to information discussed in another guide in the suite. The format 
for this type of cross-reference is "Chapter Title," Name of Guide. 

For a complete description of A/UX guides, see Road Map to A/UX. This guide contains 
descriptions of each A/UX guide, part numbers, and ordering information for all the guides in 
the A/UX documentation suite. 



Additional reading 

You receive several guides in the X Window System for A/UX package. Depending on how you 
decide to set up your X environment, you may want to focus on one guide in particular. The 
following list presents short summaries of each guide. 

■ MacXfor A/UX Supplement provides information about using the MacX display server on 
A/UX. A/UX users who want to use the MacX server should read this supplement before 
reading the MacX User's Guide. 

■ MacX User's Guide describes how to use the MacX display server on the Macintosh 
Operating System. It does not address A/UX users specifically, but most of the 
information applies to using the MacX server on A/UX. 

■ XI 1 User's Guide for A/UX txphins how to use Xll. It presents instructions about 
using menus, manipulating windows, and working with client applications in the 
Xll environment. 



xviii Gettting Started with X Window System for A/UX 

030-1727-A 



■ XI 1 Command Reference for A/UX pxtstnts detailed information about client applications 
and X commands, including command syntax, flag options, examples, and references to 
related information. 

■ XI 1 Programmer's Reference for A/UX provides information that is intended for X 
developers and programmers. It presents descriptions of the Xlib and X Toolkit 
programming libraries that come with XI 1. 

Figure P-1 illustrates the path you take when reading the X guides. 



Figure P-1 Road map to X guides 




Xll Command 

Reference 

forA/UX 
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Chapter 1 Introduction to X Window System 
forA/UX 



With the Apple® X Window System for A/UX®, you can create a 
personalized X windowing environment. You have the choice of using 
the MacX™ or XI 1 product, or elements of both. Whether you're a 
beginning X user or an experienced X programmer, these two products 
provide a flexible solution to all of your X needs. 

If you're new to X or you prefer the Macintosh® user interface, you'll want 
to use MacX. If you want your favorite Macintosh applications to share 
the desktop with X applications, you'll also want to use MacX. If you're an 
experienced X user or programmer who prefers the traditional X Window 
System interface, you'll want to use XI 1. 

This chapter can help you decide how to set up an X environment that best 
suits your needs. You'll find 

■ an explanation of what the X Window System, MacX, and XI 1 are and 
how they work 

■ an overview of the different ways you can use MacX and XI 1 on 
a network 

■ a description of the different options you have for choosing your 
X environment 

This chapter presents a general introduction to the X Window System, 
MacX, and XI 1. You can find detailed descriptions of MacX and XI 1 in 
the user guides included in the X Window System for A/UX package. 



1-1 

030-1727-A 



Understanding X 

The X Window System, called X for short, was designed at the Massachusetts Institute 
of Technology (MIT) and adapted by Apple for A/UK. You can use X to 

■ integrate different types of computers transparently on a network 

■ run applications on other computers while displaying them on your computer screen 

■ work with multiple applications simultaneously on your computer screen 

For example, you can display in a window an application running on a computer such as a 
mainframe, and at the same time display in another window an application running on another 
computer, such as a minicomputer. You can also run an application on your own computer and 
display it in a third window on your screen. You see no apparent difference in how the 
applications appear on your screen, even while they are running on different computers. 

X works through the interaction of two types of programs: display servers and client 
applications. A display server controls the flow of information between you, using the 
keyboard and mouse, and client applications. A client application is an X program, such as a 
word processor, that performs a certain task. You can run the server on your computer and use 
it to display client applications on your screen. The client applications can run on the same 
computer as the server or on other computers on a network, called host computers. 

Figure 1-1 illustrates how a server and client applications may interact. 
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Figure 1-1 The client-server model 
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X Window System for A/UX 

The X Window System for A/UX gives you MacX and XI 1. You decide how you want to use the 
two products. This section describes MacX and XI 1 and includes several examples of how you 
can use them on a network. 



MacX 

MacX is based on X Window System, Version 11, Release 4. When you receive MacX as a part of 
the X Window System for A/UX, you get 

■ the display server 

■ the xcaic client application 

When you run MacX under A/UX, you get 

■ a fully integrated environment 

MacX allows X client applications, Macintosh productivity applications, and UNIX® 
programs and applications to share your computer screen. 

■ the familiar, intuitive Macintosh user interface 

You can manipulate client applications using pull-down menus, size boxes, and scroll bars. 

■ the ability to cut and paste between different applications 

You can use the mouse and keyboard to cut and paste text and graphics between 
Macintosh, UNIX, and X applications. 

■ network transparency 

Client applications that you display on your screen can be running on different remote 
computers on a network or on your local computer. You see little difference in how the 
client applications appear on your screen, regardless of the computer on which they 
are running. 
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■ an optional mode in wliicti to display client applications 

You can display client applications in a special type of window, called a root window. You 
can simulate different X Window System environments inside the root window. 

For more information about what MacX provides, see MacX User's Guide. 



Xll 

XI 1 is based on X Window System, Version 11, Release 4. It includes 

■ the display server 

■ client applications and commands 

■ programmer libraries 

■ programmer toolkits 

When you run Xll under A/UK, you get 

■ a complete X development environment 

You can create new X programs and applications using the libraries and toolkits that come 
with Xll. 

■ an integrated UNIX and X environment 

You can run multiple X and UNIX applications simultaneously in Xll, each in its own 
window on your screen. You can access the A/UX command line by using the xterm 
client application. 

■ an X Window System user interface 

You can use pop-up menus and the mouse to manipulate windows and open client 
applications. You can also open client applications by entering commands in an 

xterm window. 
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■ network transparency 

Client applications that you display on your screen can run on different remote computers 
on a network or on your local computer. You see little difference in how the client 
applications appear on your screen, regardless of the computer on which they are running. 

For more information about what XI 1 provides, see XI 1 User's Guide for A/UX. 



Using MacX and XI 1 on a network 

You can use MacX and XI 1 on a stand-alone computer, but X is really designed to be used on 
a network. Whether you run MacX, Xll, or both X products on your computer, you can use 
them in a variety of ways on a network. Figure 1-2 illustrates several of these uses. Each 
illustration shows a different scenario for using MacX and Xll on a network with different 
types of computers. 
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Figure 1-2 Three ways to use MacX and XI 1 on a network 
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■ The first scenario sliows liow you can use MacX on a network witli computers made by 
different manufacturers. You run MacX on your Macintosti computer. You use the MacX 
server to display simultaneously on your screen client applications that are running on a 
minicomputer, a mainframe, and a Macintosh Ilex computer running XI 1. 

■ The second scenario shows how you can use XI 1 on a network with computers made 
by different manufacturers. You run XI 1 on your Macintosh computer. You use the 

XI 1 server to display simultaneously on your screen client applications that are running 
on a minicomputer and a mainframe. 

■ The third scenario shows how you can use your computer as a host computer. 
You run XI 1, which includes the full set of client applications, on your Macintosh 
computer. The Macintosh computers on the network are running MacX. Using the 
MacX server, the Macintosh computers on the network display client applications that 
are running on your computer. 

These are just a few of the many ways you can use MacX and XI 1 on a network to display client 
applications. Read the following section, "Choosing Your X Environment," to find out how 
you can choose the environment in which you use the client applications. 
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Choosing your X environment 

Both MacX and XI 1 allow you to display client applications. Each product provides 
a different environment in which to use the client applications. Depending on which 
environment you prefer, you have several options for creating an X environment on 
your computer. 

To help you decide which option you want to use, read the following sections describing the 
MacX and XI 1 environments. The accompanying figures show how your screen might look, 
depending on how you use MacX and XI 1. 



The MacX environment 

MacX gives you an X environment with the Macintosh flair. You can open and run MacX as you 
would other Macintosh applications in A/UX. Once MacX is running, you can open and display 
multiple X client applications on your screen. The client applications appear in Macintosh 
windows, and you can manipulate the windows using Macintosh-style menus and the mouse. 
You can also run UNIX programs, and other Macintosh applications such as Microsoft Word, 
concurrently with MacX. 

Figure 1-3 shows what your screen may look like when you run MacX on your computer. 
A HyperCard® stack shares the desktop with the xc lock and xcaic client applications. 
You can access files, folders, and applications on the hard disk by double-clicking their 
icons in the window. You use MukiFinder® to switch between MacX, HyperCard, and the 
A/UX Finder™. 
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Figure 1-3 The MacX environment 
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The XI 1 environment 

XI 1 gives you the standard X Window System environment. You can open client applications 
by entering commands at an A/UK command prompt. The client applications appear in 
windows that you can manipulate using pop-up menus and the mouse. You can also run UNIX 
programs simultaneously with client applications. 

Figure 1-4 shows what your screen may look like when you run Xll. Once you've installed XI 1 
on your computer, you can log in to the Xll environment from the A/UX login dialog box. Xll 
opens several client applications automatically when it starts up, including several xterm 
windows. You can access your A/UX file system and run UNIX commands from an xterm 
window. While you are in Xll, you do wo? have access to the Finder desktop environment and 
its accompanying Macintosh user interface features. 
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Figure 1-4 The XI 1 environment 
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where to go from here 

Now that you've been introduced to the Apple X Window System for A/UK, you're ready to 
install the X product that best fits your needs. Figure 1-5 illustrates which chapter you should 
read to install the X product that you need. 



■ Figure 1-5 Where to go from here 
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Chapter 2 Installing MacX for A/UX 



You can install the MacX display server on your computer if you are running 
A/UX software version 2.0 or later. This chapter shows you how to 

■ check whether you have the necessary hardware, software, and 
documentation to install MacX 

■ check whether your computer has the required 3.6 megabytes (MB) of 
free disk space 

■ check whether your computer has a kernel configured with the network 
capabilities required by MacX 

■ install the MacX application files 

■ install the MacX connection tool 

■ install the MacX fonts 

■ install the sample client application 

■ open MacX 

To learn how to use MacX on A/UX, see MacX for A/UX Supplement. For 
detailed information about MacX, see MacX User's Guide, which describes 
how to use the various MacX features. 
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what you need 

Before you install the MacX software on your Macintosh computer that is running A/UX, make 
sure you have everything you need. This includes a Macintosh computer that supports the 
MacX server and A/UX, the floppy disks that contain the MacX software, and the MacX 
documentation. Figure 2-1 illustrates what you need. 



Figure 2-1 What you need for using MacX on A/UX 
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Note: The sample client application allows you to use the MacX server to display 
a client application without requiring that you either install the entire set of XI 1 
client applications on your computer or set up client applications on another 
computer on the network. You must fully install MacX before you can open the 
sample client application. 



Starting up A/UX and logging in 

To install MacX, you must start up A/UX and log in to the A/UX Finder as the root user. A/UX is 
set by default to open the Finder desktop when you log in. 

1. Start your Macintosh computer. 

The computer displays the message "Welcome to Macintosh." 

If A/UX Startup is set as the startup application on your startup disk, the 
system automatically starts up and loads A/UX. Skip to step 4 and follow the 
login procedures. 

If A/UX does not start automatically, continue with the next step and follow the 
instructions to run A/UX Startup manually. 

2. Open the MacPartition hard disk icon by double-clicking it. 

You double-click an icon by positioning the pointer on the icon and pressing the 
mouse button twice in rapid succession. You can also open an icon by selecting it 
and choosing Open from the File menu. 

The MacPartition window appears, as shown in Figure 2-2. 
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Figure 2-2 The MacPartition window 
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3. Open the A/UX Startup application by double-clicking its icon. 

Your screen displays messages thiat report the progress toward loading and 
initializing A/UX. Next, the A/UX login dialog box appears, as shown in Figure 2-3. 



Figure 2-3 The A/UX login dialog box 
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4. Type root in the Name text box and press Tab. 

5. Type the password for the root account in the Password text box. 
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If the root account does not have a password, just press Return. This automatically 
starts the login process; you do not have to go to step 6. When you are successfully 
logged in, the Finder desktop appears, as shown in Figure 2-4, 

6. Click Login or press Return. 

You see a message about starting a session for root. When you are successfully 
logged in, the Finder desktop appears, as shown in Figure 2-4. 



Figure 2-4 The Finder desktop in A/UX 
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checking your system's configuration 

Before you can install and run MacX on your computer, you need to check for sufficient disk 
space and check for a network kernel. 

♦ Note: If you know that your computer has 3.6 MB or more of disk space, and if you 
have already configured a network kernel into your system, you can skip this section. 
Go to the section "Installing the MacX Software on A/UX" later in this chapter for 
step-by-step instructions that describe how to install and set up MacX. 



Checking free disk space 

You can use the df command to check the amount of free disk space on your computer. You 
need approximately 3.6 MB of free disk space to run the MacX server on A/UX. The following 
steps describe how to use df in a CommandShell window. If necessary, see the section 
"Starting Up A/UK and Logging In" earlier in this chapter to get to the Finder desktop in A/UX. 

1. On the desktop, choose CommandShell from the Apple menu. 

To choose a command from a menu, you position the pointer on the menu title in 
the menu bar and press the mouse button. While holding down the mouse button, 
drag to the command you want, and then release the mouse button. A CommandShell 
window appears with a command prompt. (If a CommandShell window does not 
appear, press Command-N or choose New from the File menu while in the 
CommandShell application.) 

2. Enter df at the command prompt. 

To enter a command, you type the command and press Return. The system returns 
the number of free disk blocks, for example, 

/ /dev/dsk/c5d0s0 33720 blocks 9112 i-nodes 

A block consists of 512 bytes. You need approximately 7200 blocks for the 3.6 MB 
of free disk space that MacX requires. If you do not have enough blocks, delete 
unnecessary files or archive old files to free disk space. 
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If you need to check whether you have a network kernel configured for MacX, leave 
the CommandShell window open and go to the next section, "Checking for a 
Network Kernel." 

If you know that you already have a network kernel configured for MacX, you can 
close the CommandShell window now by clicking its close box. Go to the section 
"Installing the MacX Software on A/UX" later in this chapter. 

For additional information about obtaining more disk space, read the section "Reclaiming 
Disk Space" in Chapter 6, "Managing Disks," o^ A/UX Local System Administration. 



Checking for a network kernel 

Whether you plan to run MacX on a network or stand-alone system, you need to have a 
network kernel set up. Follow these steps to check whether your system has a network kernel. 
If necessary, see the section "Starting Up A/UX and Logging In" earlier in this chapter to get to 
the Finder desktop in A/UX. 

1. If you don't already have a CommandShell window open, choose 
CommandShell from the Apple menu on the desktop. 

A CommandShell window appears with a command prompt. (If a CommandShell 
window does not appear, press Command-N or choose New from the File menu while 
in the CommandShell application.) 

2. Enter riogin loop at the command prompt. 

n If you have a network kernel set up, this command "remotely" logs you in to your own 
computer. The system prompts you for your terminal type. For example, you see 
TERM = ( vt 1 ) . This means that MacX can run on your computer. 

Go to step 3. 

D If a network kernel is not set up, you see the message 

loop: Connection refused 

This means that you need to create a network kernel on your A/UX computer before you 

can run MacX. 
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Go to the Appendix, "Setting Up a Network Kernel," for instructions about using tlie 
newconf ig command to create an NFS kernel or a plain TCP/IP kernel. If you are 
planning to put your computer on a network, see Chapter 2, "Establishing a Two-System 
Network," in A/UX Network System Administration for more information about using 
the newconf ig command. 

3. Press Return to accept the terminal type, and enter exit. 

This ends the remote login session and returns you to the prompt in the 
CommandShell window. 

4. Click the close box in the CommandShell window. 

The current CommandShell window closes, but CommandShell is still active. 



Installing the MacX software on A/UX 

The installation procedures are divided into four sections. You must follow the steps in all four 
of these sections to run MacX on A/UX: 

■ "Installing the MacX Application Files" 

■ "Installing the MacX Connection Tool" 

■ "Installing the MacX Fonts" 

■ "Installing the Sample Client Application" 

♦ Note: Before you begin inserting the MacX disks, lock them to ensure that you don't 
accidentally erase any information. A disk is locked when you can see through the 
square hole on the top-right side of the disk. 
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Installing the MacX application files 

Follow these steps to install the MacX application files on your system. These steps assume 
that you are starting from the Finder desktop in A/UX. For instructions about getting to the 
desktop, read "Starting Up A/UX and Logging In" earlier in this chapter. On the desktop you 
install the MacX files using traditional Macintosh actions such as clicking and dragging to 
copy files. 

1. Open the hard disk icon labeled / . 

You double-click the icon to open it. A disk directory window appears that contains 
the files, folders, and commands on your hard disk. 

2. Open the /users folder by double-clicking its icon. 

You may need to scroll through the window to find the /users folder. Click the 
scroll bar arrows on the right side of the window to scroll up or down. 

A directory window appears containing folders that represent the home directories 
of the various user accounts, such as Guest and start. 

3. Find the folder whose name is the same as your A/UX user name. 

The folder whose name is the same as your A/UX user name represents your home 
directory. Your home directory is set up when your user account is created. 

A Important If you do not have a user account, you can install the MacX files 
into the /users directory now and copy them to your home 
directory later. To learn about user accounts and home directories, 
see Chapter 2, "Adding and Managing User Accounts," in the guide 
Setting Up Accounts and Peripherals for A/UX. a 

4. Insert the MacX Application disk. 

The MacX Application disk icon appears. 
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5. Open the MacX Application disk icon by double-clicking it. 

A window like the one in Figure 2-5 appears with an icon for the MacX application. If 
necessary, position the MacX Application window so that you can also see the folder 
representing your home directory in the /users window. 



Figure 2-5 The MacX Application window 
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6. Drag the MacX icon to the folder that represents your home directory. 

The folder whose name is the same as your A/UX user name represents your home 
directory. When you release the mouse button, the MacX application is copied to 
your hard disk. This may take a minute. 

7. Click the close box in the MacX Application window. 

8. Eject the MacX Application disk by dragging its icon to the Trash. 

9. Insert the MacX Communications disk. 

The MacX Communications disk icon appears. 

10. Open the MacX Communications disk icon by double-clicking it. 

A window like the one in Figure 2-6 appears with icons that represent a folder named 
"for System Folder," a folder named "for Communications Folder," the MacX Fonts 
folder, a Read Me document, the TeachText application, the MacX Colors file, and a 
MacX settings document called Sample. If necessary, position the MacX 
Communications window so that you can also see the folder representing your home 
directory in the /users window. 
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Figure 2-6 The MacX Communications window 
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Note: For now, ignore the folders named "for Communications Folder" and 
"for System Folder." The files in the folder named "for Communications Folder" 
require a different installation procedure from the one described in this section. 
You won't need to install any of the files in the folder named "for System Folder." 
See the next section, "Installing the MacX Connection Tool," for more information. 



11. Select all the icons except the folders named "for System Folder" and 
"for Communications Folder." 

You should select the MacX Fonts folder, the Read Me document, the TeachText 
application, the MacX Colors file, and the MacX settings document called Sample. 

To select multiple icons, hold down the SHIFT key and click the icons. When all the 
icons you want are selected, release Shift. The icons remain selected. You can use 
the mouse to drag the icons to another location, such as a folder or hard disk icon. 

12. Drag the selected icons from the MacX Communications window to the 
folder that represents your home directory. 

This procedure copies the selected files to your hard disk. The folder 
representing your home directory should now contain the MacX application 
file that you installed in the previous section and the files you copied from the 
MacX Communications disk. 
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Important Leave the MacX Communications window open. In the 

following section, you will be copying additional files from 
the MacX Communications disk to your system, a 



Follow the instructions in the next section, "Installing the MacX Connection Tool," to continue 
the MacX installation. 



Installitig the MacX connection tool 

MacX provides a connection tool, called the MacTCP Tool, that allows MacX to communicate 
with other computers over a network. Installing the connection tool is a little more 
complicated than installing the other MacX files. You must install the MacTCP Tool in the 
folder on your hard disk named Communications Folder. This folder is located in the folder 
named System Folder, which is located in the sys folder, which is located in the mac folder. 
If you're familiar with UNIX terminology, think of what you're about to do as installing the 
MacTCP Tool in the directory /mac/sys/System Folder/Communications Folder. 

These steps assume that you can see the MacX Communications window on your desktop. 
If you do not have the MacX Communications disk in your floppy disk drive, find the 
MacX Communications disk, insert it, and double-click the disk icon to open it. 

1. Find the MacX Communications window. 

The MacX Communications window should be open if you have completed 
the procedures described in the previous section, "Installing the MacX 
Application Files." 

Figure 2-6 shows the icons in the MacX Communications window. Notice the folder 
labeled "for Communications Folder." This is the only folder you need to use. The 
files in the folder named "for System Folder" are already included with A/UK. 



A Important Do not install any of the files in the folder named 
"for System Folder." a 
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2. Open the folder named "for Communications Folder" by double-clicking 
its icon. 

The "for Communications Folder" window in Figure 2-7 appears containing the 
MacTCP Tool. 



Figure 2-7 The "for Communications Folder" window 
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3. Go to the /mac/ sys/ System Folder directory on your hard disk. 

To get to the /mac/ sys/ System Folder directory, Open the mac folder in your 
hard disk window by double-clicking the folder. The mac window appears. In the 
mac window, open the sys folder. In the sys window that appears, open the 
System Folder. (Make sure you open the folder named System Folder, not Login 
System Folder or Startup System Folder.) The System Folder window displays the 
directory that is referred to as /mac/sys /System Folder. 

4. Find the Communications Folder in the System Folder window. 

You may need to scroll through the window to find the Communications Folder. 
Click the scroll bar arrows on the right side of the window to scroll up or down. 

5. Drag the MacTCP Tool icon from the "for Communications Folder" window 
to the Communications Folder in the System Folder window. 

You may need to reposition the windows on your desktop in order to see both the 
MacTCP Tool icon and the Communications Folder. 

When you release the mouse button, MacTCP Tool is copied to the 
/mac/sys/System Folder/Communications Folder directory onyour 
hard disk. 
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6. Click the close box in the "for Communications Folder" window. 

7. Click the close box in the MacX Communications window. 

8. Eject the MacX Communications disk by dragging it to the Trash. 

9. Close the System Folder, sys, and mac windows by clicking the close box 
in each window. 

You should still see open windows representing /users and your hard disk. 

A Important If you have a personal System Folder in your user account, you must 
perform an additional step in order to install and open MacX. You 
need to copy the MacTCP Tool to the Communications Folder in 
your personal System Folder (as well as to the Communications 
Folder in the global System Folder). Specifically, you must copy the 
MacTCP Tool to 

/users/ USername/ System Folder/Communications Folder 

where username reprtsenls your A/UX user name. For example, if your 
user name is chris, you drag the MacTCP Tool from the MacX 
Communications disk to the Communications Folder in the System 
Folder located in your home directory. In other words, you copy the 
MacTCP Tool to the folder that represents this directory: 

/users/chris/System Folder/Communications Folder 

For information about personal System Folders, see Chapter 3, 
"Customizing Your Work Environment," in A/UX Essentials, a 



Follow the instructions in the next section, "Installing the MacX Fonts," to continue the 
MacX installation. 
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Installing the MacX fonts 

Three MacX disks contain tine MacX fonts. You need thie fonts on ail tliree dislcs in order to run 
MacX. Follow these steps to install the MacX fonts. 

1. Open the folder representing your home directory. 

A folder directory window appears. It contains the MacX files that you installed in 
the previous sections. Notice that it includes a folder named MacX Fonts. When you 
install the MacX fonts in the next step, you must copy them to this folder. 



A Important Do not change the name of the MacX Fonts folder. Whenever you 
open the MacX server, the MacX application looks for a folder 
named MacX Fonts. If the application cannot find a folder with 
that name, MacX won't run. 



A 



2. Insert the MacX Fonts 1 disk. 

The MacX Fonts 1 disk icon appears. 

3. Open the MacX Fonts 1 disk icon by double-clicking it. 

The MacX Fonts 1 window appears, as shown in Figure 2-8. Notice the three font 
folders in the window. You need to install all of these in order to run MacX. If 
necessary, position the MacX Fonts 1 window so that you can also see the MacX 
Fonts folder in the window that contains the MacX application files on your 
hard disk. 



Figure 2-8 The MacX Fonts 1 window 
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4. Select all of the folders in the MacX Fonts 1 window by pressing Command-A. 

5. Drag the folders to the MacX Fonts folder. 

When you release the mouse button, the folders and the fonts in them are copied to 
the MacX Fonts folder, which is on your hard disk. 

6. Click the close box in the MacX Fonts 1 window. 

7. Eject the MacX Fonts 1 disk by dragging its icon to the Trash. 

8. Repeat steps 2 through 7 for the MacX Fonts 2 disk. 

There are four font folders on the MacX Fonts 2 disk. You need to install all of these 
folders in order to run MacX. When you open the MacX Fonts 2 disk icon, you'll see a 
window, as shown in Figure 2-9. 

■ Figure 2-9 The MacX Fonts 2 window 
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9. Repeat steps 2 through 7 for the MacX Fonts 3 disk. 

There are five font folders on the MacX Fonts 3 disk. You need to install all of these 
folders in order to run MacX. When you open the MacX Fonts 3 disk icon, you'll see a 
disk window, as shown in Figure 2-10. 
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Figure 2-10 The MacX Fonts 3 window 
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Continue installing the MacX software by going to the next section, "Installing the 
Sample Client Application," which provides step-by-step instructions for installing the 
xcaic client application. 



Installing the sample client application 

Installing the sample client application is a lot like installing the MacX connection tool. In 
addition to copying the xcaic client application to your hard disk, you need to install the 
xcaic Commando dialog in the directory /mac/iib/cmdo/x. 

Follow these steps to install the sample client application. 

1. Insert the MacX for A/UX Sample Client disk. 
The MacX for A/UX Sample Client disk icon appears. 

2. Open the MacX for A/UX Sample Client icon by double-cUcking it. 

A window appears that contains an icon for the xcaic client application and a 
folder named "for /mac/iib/cmdo/x/." Figure 2-11 shows the MacX for A/UX 
Sample Client window. 
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Figure 2-11 The MacX for A/UX Sample Client window 
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3. Drag the xcaic icon to the window representing your home directory. 

This is the window whose name is the same as your A/UX user name. "When you release 
the mouse button, the xcaic client application is copied to your hard disk. 

4. Go to the /mac/iib/cmdo directory on your hard disk. 

To get to the /mac/iib/cmdo directory, open the mac folder in the hard disk 
window by double-clicking it. The mac window appears. In the mac window, open 
the lib folder. In the lib window that appears, open the cmdo folder. (Opening 
the cmdo folder may take a few moments.) 

5. Find the folder named x in the cmdo window. 

You may need to scroll through the window to find the x folder. Click the scroll bar 
arrows on the right side of the window to scroll up or down. 

6. In the MacX for A/UX Sample Client window, open the "for 
/mac/iib/cmdo/x/" folder by double-clicking it. 

The "for /mac / lib/ cmdo / x / " window appears, as shown in Figure 2-12. It 
contains a Commando icon named xcaic This icon represents the xcaic 
Commando dialog box. 
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Figure 2-12 The "for /mac/iib/cmdo/x/" window 
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7. Drag the xcaic Commando icon to the x folder in the cmdo window. 

When you release the mouse button, the xcaic Commando dialog box is copied to 
the /mac/iib/cmdo/x/ directory on your hard disk. 

8. Press OPTION and click the close box in any window. 

This closes all the open windows on your screen. 

9. Eject the MacXfor A/UX Sample Client disk by dragging its icon to 
the Trash. 

Go to the next section, "Opening the MacX Application," for information about opening 
MacX for the first time. 



Opening the MacX application 

Follow these steps to open MacX. 

1. Open the folder that contains the MacX application icon. 

The MacX application should be in the folder that represents your home directory. 
If necessary, open your hard disk icon, open the /users folder, and then open the 
folder labeled with your A/UX user name. 
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2. Double-click the MacX application icon to open the MacX server. 

A window about MacX appears, followed by a window that contains messages about 
updating the Font Directory file. When MacX is successfully loaded, your desktop 
should look similar to Figure 2-13. Notice the menu titles in the menu bar and the 
icon at the right edge of the menu bar. You are now in the MacX application. 

To quit MacX quickly and simply, press COMMAND-Q or choose Quit from the 
File menu. 



Figure 2-13 MacX 
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optimizing MacX performance 

You may want to adjust the size of the MacX application to optimize the performance of 
MacX, especially if you plan to display a significant number of client applications. Follow 
these steps to change the application size of MacX. 

1. Open the folder that contains the MacX application icon. 

The MacX application should be in the folder that represents your home directory. 
If necessary, open your hard disk icon, open the /users folder, and then open the 
folder labeled with your A/UX user name. 

2. Select the MacX appUcation icon. 

You select an icon by positioning the pointer on the icon and pressing the mouse 
button once. This highlights the MacX application icon. 

♦ Note: Make sure you do not double-click the MacX application icon. Double- 
clicking the icon starts the application. If you accidentally start MacX, simply 
quit MacX by pressing COMMAND-Q, and then repeat step 2 correctly. 

3. Choose Get Info from the File menu or press Command-I. 

An Info window appears, as shown in Figure 2-14. This window contains information 
about the MacX application, including modification dates and application size. 



Chapter 2 Installing MacX for A/UX 2-21 

030-1727-A 



Figure 2-14 The MacX Info window 
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4. Double-click the number in the Application Memory Size box or press Tab. 

5. Type a new application size. 

If your computer is low on random-access memory (RAM), you may want to increase 
the size by increments of 500 (K). You can experiment with different sizes for the 
MacX application to find the maximum size your system will support. 
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A Important If you exceed the maximum application size that your system is 
able to support, you will see an alert box when you try to open 
MacX. If this happens, click Cancel, repeat steps 2-5 in this 
section, and type a smaller application size in the Info window, a 

6. Click the close box in the Info window. 

The changes you made to the size of the MacX application take effect immediately. 



Where to go from here 

Go to MacX for A/UX Supplement to learn how to use the MacX server on A/UX. The supplement 
provides tutorial steps for using the MacX server to display local client applications. Read 
MacX User's Guide to learn how to use additional MacX features. 

If you want to install Xll, go to Chapter 3, "Installing Xll." 
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Chapter 3 Installing XI 1 



This chapter describes how to install the XI 1 software. To install and set 
upXll, you need to 

■ check whether you have the necessary hardware, software, and 
documentation to install XI 1 

■ check whether your computer has the required l6 megabytes (MB) of 
free disk space 

■ check whether your computer has a kernel configured with the network 
support required by XI 1 

■ install the XI 1 software 

■ set up XI 1 startup files 

■ start XI 1 for the first time 

For detailed information about using XI 1, see 111 User's Guide for A/UX. 

If you are an advanced A/UX user and want to install XI 1 on a separate 
A/UX partition, make sure you have available A/UX Installation Guide and 
Setting Up Accounts and Peripherals for A/UX. Those guides are included in 
the Accessory Kit that comes with your A/UX system. 

♦ Note: If you have a previous version of Xll installed on your 
computer, skip the following sections about checking your 
system's configuration and go to the section "Installing the 
Xll Software." 
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what you need 

Before you install the XI 1 software on your Macintosh computer that is running A/UX, make 
sure you have everything you need. This includes a Macintosh computer system that supports 
XI 1 and A/UX, the floppy disks that contain the XI 1 software, and the XI 1 documentation. 
Figure 3-1 illustrates what you need. 



Figure 3-1 What you need for using XI 1 



Getting started 
with X Window 
System for A/UX 



Xll Command 
Reference 
for A/UX 



Xll User's 
Guide for A/UX 



Xll 
Programmer's 

Reference 

forA/UX 























Macintosh II family of computers 
or Macintosh SE/30 




Xll Installation Disks 1-12 
Installer for Xll 



3-2 Getting Started with X Window System for A/UX 

030-1727-A 



Monitors and video cards 

XI 1 can use any A/UX software-compatible NuBus™ video card and high-resolution monitor. 
It can use any size and number of monitors, which can be either color or monochrome. It can 
also make use of the built-in video feature available in such computers as the Macintosh Ilci 
and the Macintosh SE/30. (The Xll display server supports 1-bit monochrome and 8-bit 
color depths.) 

A/UX informs Xll of the size, numbers, and depths of all built-in video cards and of all video 
cards installed in the system's expansion slots. You do not need to take any special actions 
when setting up different display configurations. 

You can connect up to six monitors to a system running Xll, as Figure 3-2 illustrates. The 
monitors do not need to be the same make or type. For example, you can run a monochrome 
monitor and a color monitor from Xll. Such a configuration would consist of Xll being used 
by one user, with one keyboard, one mouse, and several monitors. 



Figure 3-2 Multiple monitors 
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XI 1 is not designed for, nor does it support the use of, an ASCII terminal connected to a serial 
port. Rather, each monitor must be a high-resolution monitor connected to its own NuBus 
video card or to a built-in video port. 



Starting up A/UX and logging in 

To install Xll, you must start up A/UX and log in to the A/UX Finder as the root user. A/UX is set 
by default to open the Finder desktop when you log in. 

1. Start your Macintosh computer. 

The computer displays the message "Welcome to Macintosh." 

If A/UX Startup is set as the startup application on your startup disk, the 
system automatically starts up and loads A/UX, Skip to step 4 and follow 
the login procedures. 

If A/UX does not start automatically, continue with the next step and follow the 
instructions to run A/UX Startup manually. 

2. Open the MacPartition hard disk icon by double-clicking it. 

You double-click an icon by positioning the pointer on the icon and pressing the 
mouse button twice in rapid succession. You can also open an icon by selecting it 
and choosing Open from the File menu. 

The MacPartition window appears, as shown in Figure 3-3. 
■ Figure 3-3 The MacPartition window 
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3. Open the A/UX Startup application by double-clicking its icon. 

Your screen displays messages that report the progress toward loading and 
initializing A/UX. Next, the A/UX login dialog box appears, as shown in Figure 3-4. 

■ Figure 3-4 The A/UX login dialog box 
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4. Type root in the Name text box and press Tab. 

5. Type the password for the root account in the Password text box. 

If the root account does not have a password, just press RETURN. This starts the 
login process automatically; you do not have to go to step 6. When you are 
successfully logged in, the Finder desktop appears, as shown in Figure 3-5. 

6. Click Login or press Return. 

You see a message about starting a session for root. When you are successfully 
logged in, the Finder desktop appears, as shown in Figure 3-5. 
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Figure 3-5 The Finder desktop in A/UX 
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Checking your system's configuration 

Before you can install and mn XI 1 on your computer, you need to check for sufficient disk 
space and check for a network kernel. 

♦ Note: If you already know that your computer has 1 6 MB of disk space, and if you 
have already configured a network kernel into your system, you can skip this section. 
Go to the section "Installing the XI 1 Software" later in this chapter for step-by-step 
instructions that describe how to install and set up Xll. 
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checking free disk space 

You can use the df command to check the amount of free disk space on your computer. 
You need to have at least 1 6 MB of free disk space to run XI 1 on A/UX. The following steps 
describe how to use df in a CommandShell window. If necessary, see the section "Starting Up 
A/UX and Logging In" earlier in this chapter to get to the Finder desktop in A/UX. 

1. On the desktop, choose CommandShell from the Apple menu. 

To choose a command from a menu, you position the pointer on the menu title in 
the menu bar and press the mouse button. While holding down the mouse button, 
drag to the command you want, and then release the mouse button. A CommandShell 
window appears with a command prompt. (If a CommandShell window does not 
appear, press Command-N or choose New from the File menu while in the 
CommandShell application.) 

2. Enter df at the command prompt. 

To enter a command, you type the command and press RETURN. The system returns 
the number of free disk blocks, for example, 

/ /dev/dsk/c5d0s0 33720 blocks 9112 i-nodes 

A block consists of 512 bytes. You need 32,000 blocks for the l6 MB of free disk 
space that Xll requires. If you do not have enough blocks, delete unnecessary files 
or archive old files to free disk space. 

If you need to check whether you have a network kernel configured for Xll, leave 
the CommandShell window open and go to the next section, "Checking for a 
Network Kernel." 

If you know that you already have a network kernel configured for Xll, you can 
close the CommandShell window now by clicking its close box. Go to the section 
"Installing the Xll Software" later in this chapter. 

For additional information about obtaining more disk space, read the section "Reclaiming 
Disk Space" in Chapter 6, "Managing Disks," of A/UX Local System Administration. 
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checking for a network kernel 

Whether you plan to run XI 1 on a network or stand-alone system, you need to have a network 
kernel set up. Follow these steps to check whether your system has a network kernel. If 
necessary, see the section "Starting Up A/UX and Logging In" earlier in this chapter to get to 
the Finder desktop in A/UX. 

1. If you don't already have a CommandShell window open, choose 
CommandShell from the Apple menu on the desktop. 

A CommandShell window appears with a command prompt. (If a CommandShell 
window does not appear, press COMMAND-N or choose New from the File menu while 
in the CommandShell application.) 

2. Enter riogin loop at the command prompt. 

D If you have a network kernel set up, this command "remotely" logs you in to your own 
computer. The system prompts you for your terminal type. For example, you see 
TERM = ( vt 1 ) . This means that XI 1 can run on your computer. 

Go to step 3. 
D If a network kernel is not set up, you see the message 
loop: Connection refused 

This means that you need to create a network kernel on your computer before you can 
runXll. 

Go to the Appendix, "Setting Up a Network Kernel," for instructions about using the 
newconf ig command to create an NFS kernel or a plain TCP/IP kernel. If you are 
planning to put your computer on a network, see Chapter 2, "Establishing a Two-System 
Network," in A/UX Network System Administration for more information about using 
the newconf ig command. 

3. Press Return to accept the terminal type, and enter exit. 

This ends the remote login session and returns you to the prompt in the 
CommandShell window. 

Go to the next section, "Installing the Xll Software." 
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Installing the XI 1 software 

To install the XI 1 software, you perform the following steps. 

■ Copy the XI 1 Installer program from the Installer for XI 1 disk to your A/UX system. Follow 
the instructions in the section "Copying the XI 1 Installer Program to Your Hard Disk." 

■ Use the XI 1 Installer to install the XI 1 files from the floppy disks. 

n If you are installing XI 1 for the first time and want to install Xll on the hard disk that 
contains your A/UX root file system, follow the instructions in the section "Installing 
Xll on Your A/UX System." 

a If you are updating an existing XI 1 system to a new version, make sure you back up any 
Xll files you may have changed. After you've backed up files, follow the instructions in 
the section "Installing Xll on Your A/UX System." 

n If you are an advanced A/UX user and plan to install Xll on a hard disk other than the 
one containing your A/UX root file system, follow the instructions in the section 
"Installing Xll Under a Different Directory." 

After installing Xll, go to the section "Setting Up Xll" for instructions about how to prepare 
you A/UX system to run Xll. 

♦ Note: On the desktop, the hard disk icon labeled / represents your A/UX root 
file system. 



Copying the Xll Installer program to your hard disk 

Follow these steps to copy the Xll Installer program to your Macintosh computer running 
A/UX. These instructions assume you are starting from the Finder desktop in A/UX. For 
instructions on getting to the desktop, see "Starting Up A/UX and Logging In" eariier in 
this chapter. 
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1. Insert the Installer for XI 1 disk into the right-hand disk drive. 

If a dialog box appears and asks you to identify the type of floppy disk, dick the 
button labeled Macintosh to specify that the disk contains Macintosh files. 

2. Open the Installer for Xll disk icon by double-clicking it. 

A window like the one in Figure 3-6 appears with several icons. Notice the icon 
labeled Xll Installer. You use this program to install the Xll files. 

■ Figure 3-6 The Installer for Xll window 
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3. Select all the icons that appear in the Installer for Xll window by pressing 

COMMAND-A. 

4. Drag the files to the hard disk (/) that contains your A/UX root file system. 

This copies the Xll Installer program to your hard disk. 

5. Close the Installer for Xll window and eject the disk. 

Click the window's close box, and eject the disk by dragging the disk icon to 
the Trash. 
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A Important Make sure you eject and remove the Installer for XI 1 disk before 
starting the XI 1 Installer program. Once you start the XI 1 Installer 
program, you will need to insert the disks containing the XI 1 files 
into the right-hand disk drive, a 



After you have copied the XI 1 Installer program to your hard disk, you are ready to install the 
Xll files from XI 1 Installation Disks 1-12. 



Installing Xll on your A/UX system 

Follow these steps to install the Xll files on the hard disk, called /, that contains your A/UX 
root file system. These instructions assume you are starting from the Finder desktop in A/UX. 
For instructions on getting to the desktop, see "Starting Up A/UX and Logging In" earlier in 
this chapter. 

1. Open your hard disk (/) and find the Xll Installer icon. 

2. Start the Xll Installer program by double-clicking its icon. 

A Commando dialog box appears for the Xll Installer, as shown in Figure 3-7. 



■ Figure 3-7 The Xll Installer Commando dialog 
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3. Click Xll Installer to accept / as the default directory. 

♦ Note: Unless you're an advanced A/UX user, it's a good idea to install the Xll files 
under the root (/) directory. If you want to install Xll in a different directory, 
go to the section "Installing Xll Under a Different Directory," later in this 
chapter, for more information. 

After you click Xll Installer, a CommandShell window appears displaying the 
following messages about the Xll installation: 

Welcome to the X Window System for A/UX Installation 
Procedure . 

If you have two floppy disk drives, be sure to insert all 
disks only into drive when prompted. 

It is not recommended that you interrupt this procedure. 
However, if you must do so, you may type q at any time while 
the program is waiting for a floppy. 

Press RETURN to continue 

For information about interrupting the Xll installation, go to the section "Stopping 
and Restarting the Installation" later in this chapter. 

4. Press Return to continue with the installation. 

You see the following message: 

Checking to see if there is enough room to install Xll . . . 

If you have the required 1 6 MB of free disk space on your computer, you see the 
following messages: 

Please insert Xll Installation Disks as prompted. 
Waiting for floppy Insert disk 1 

♦ Note: If you do not have the required amount of free disk space, the Xll 
Installer stops the installation and returns a command prompt. After you have 
created the necessary 1 6 MB of free disk space by backing up and removing 
files, begin the installation again by starting with step 1 in this section. 

A Important If you have two floppy disk drives, you must use the right-hand disk 
drive (drive 0) during the Xll installation procedure, a 
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5. Insert X// Installation Disk 1 into the right-hand disk drive. 

A Important Do not press Return after you insert the floppy disk, a 

The XI 1 Installer loads the files from XI 1 Installation Disk 1 onto your computer and 
displays the following message: 

Processing disk 1. 

When all files on Xll Installation Disk 1 are loaded, you see these messages: 

Waiting for floppy Insert disk 2 

6. Install the 11 remaining Xll installation disks. 

These disks are labeled Xll Installation D/5^ 2 through Xll Installation Disk 12. The 
Xll Installer continues to prompt you to insert the rest of the disks. When it finishes 
loading the final disk, the program displays the following messages: 

Finished with installation. 
Cleaning up ... 

After several moments, you see messages about finishing the Xll installation. 

To complete the Xll installation, you must give yourself access to Xll. Follow the instructions 
in the section "Setting Up Xll" later in this chapter. 



Installing Xll under a different directory 

This section describes how to install Xll on a separate hard disk that does not contain your 
A/UX root file system. 

A Important The installation procedure described in this section is for advanced 
A/UX users only. All other users should follow the installation 
instructions presented in the section "Installing Xll on Your A/UX 
System." The following procedure assumes that you understand the 
UNIX concepts of partitioning and mounting hard disks, a 
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1. Prepare your external hard disk drive. 

To prepare a hard disk, you must perform these procedures: 

n If necessary, initialize the hard disk using the Apple HD SC Setup program. 

a Partition the hard disk using the Apple HD SC Setup program. 

D Make a file system on the hard disk using the newf s command. 

n Mount the file system using the mount command. 

The procedures listed above are described in detail in Chapter 4, "Adding and 
Managing Hard Disk SCs," in the guide Setting Up Accounts and Peripherals. 

2. Open your hard disk (/) and find the Xll Installer icon. 

3. Start the Xll Installer program by double-clicking its icon. 

A Commando dialog box appears for the Xll Installer, as shown in Figure 3-8. 

■ Figure 3-8 The Xll Installer Commando dialog 
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4. Chck "Choose install directory." 

The dialog box in Figure 3-9 appears. 
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Figure 3-9 Choosing an installation directory 
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5. Find the directory under which you want to install XI 1, and select it by 
clicking it once. 

Select the directory at which you mounted the hard disk you set up for XI 1. 

For example, if you mounted the file system on your hard disk at the /mnt directory, 
you would select /mnt as the directory under which to install Xll. Figure 3-9 shows 
/mnt selected. This means that when you install Xll, its directories and files will be 
created under /mnt. For example, the xterm client application will be in the 
/mnt/usr/bin/xii directory. 

6. Click Add. 

The name of the directory you selected appears in the "Select directories" box. 
Make sure this directory is the one under which you want to install Xll. 

7. Click Done. 

You return to the Xll Installer Commando dialog box. 
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8. Click XI 1 Installer to start the XI 1 Installer program. 

After you click XI 1 Installer, a CommandShell window appears displaying the 
following messages about the XI 1 installation: 

Welcome to the X Window System for A/UX Installation 
Procedure . 

If you have two floppy disk drives, be sure to insert all 
disks only into drive when prompted. 

It is not recommended that you interrupt this procedure. 
However, if you must do so, you may type q at any time while 
the program is waiting for a floppy. 

Press RETURN to continue 

For information about interrupting the XI 1 installation, go to the section 
"Stopping and Restarting the Installation" later in this chapter. 

9. Press Return to continue with the installation. 

You see the following message: 

Checking to see if there is enough room to install Xll . . . 

If you have the required 1 6 MB of free disk space on your hard disk, you see the 
following messages: 

Please insert Xll Installation Disks as prompted. 
Waiting for floppy Insert disk 1 

♦ Note: If you do not have the required amount of free disk space, the Xll 
Installer stops the installation and returns a command prompt. After you have 
created the necessary 1 6 MB of free disk space by backing up and removing 
files, begin the installation again by starting with step 1 in this section. 

A Important If you have two floppy disk drives, you must use the right-hand disk 
drive (drive 0) during the Xll installation procedure, a 

10. Insert X// Installation Disk 1 into the right-hand disk drive. 
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Important Do not press Return after you insert the floppy disk. 



A 



The XI 1 Installer loads the files from XI 1 Installation Disk 1 onto your hard disk and 
displays the following message: 

Processing disk 1. 

When all files on XI 1 Installation Disk 1 are loaded, you see these messages: 

Waiting for floppy Insert disk 2 

11. Install the 11 remaining Xll installation disks. 

These disks are labeled XII Installation Disk 2 through XII Installation Disk 12. The 
Xll Installer continues to prompt you to insert the rest of the disks. When it finishes 
loading the final disk, the program displays the following messages: 

Finished with installation. 
Cleaning up ... 

After several moments, you see messages about finishing the Xll installation. 

To complete the Xll installation, you must give yourself access to Xll. Follow the instructions 
in the section "Setting Up Xll" later in this chapter. 



Stopping and restarting the installation 

During the Xll installation, you may need to stop the installation procedure. The 
following sections describe how to intermpt the Xll installation and how to resume 
after an interruption. 



Interrupting the Xll installation 

To interrupt the Xll installation procedure, enter q when the Xll Installer program prompts 
you to insert an Xll installation disk. You see this message: 

Quitting installation procedure. 
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The XI 1 Installer program returns a command prompt. You can either resume the installation 
immediately by restarting the XI 1 Installer or perform the XI 1 installation at a later date. See 
the following section, "Resuming the XI 1 Installation," to learn how to restart the installation. 

A Important Do not interrupt the Xll installation at any point other than when the 
XI 1 Installer program prompts you for a disk, a 



Resuming the Xll installation 

If the Xll installation is interrupted for any reason, the Xll Installer program resumes at 
the correct point the next time you run it. To resume an interrupted installation, follow 
these steps. 

1. Find the Xll Installer on your hard disk (/). 

2. Double-click the Xll Installer icon to start the program. 

The Xll Installer automatically prompts you for the correct Xll installation disk. 
This feature saves you the trouble of reloading the Xll files that are already installed. 
You see the following messages: 

Xll has been partially installed; continuing with disk n 
Press RETURN to continue 

3. Press Return. 

4. Return to the section of this chapter that describes the Xll installation you 
want to perform. 

If you are an advanced user, go to the section "Installing Xll Under a Different 
Directory." Otherwise, go to the section "Installing Xll on Your A/UX System." 
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Setting up XI 1 

Once you have installed the XI 1 software, you need to perform two sets of tasks: 

■ Copy startup files to your home directory. 

■ Adjust the path environment variable in your shell startup script. 

A Important Make sure you perform these tasks for each person who will be usin^ 
XI 1. You must copy the startup files to each user's home directory 
and adjust the path environment variable in each user's shell 
startup script, a 



Copying startup files 

These steps assume that you are logged in to the Finder desktop in A/UX as the root user. 

1. If you don't already have a CommandShell window open, choose 
CommandShell from the Apple menu on the desktop. 

A CommandShell window appears with a command prompt. (If a CommandShell 
window does not appear, press Command-N or choose New from the File menu while 
in the CommandShell application.) 

2. Copy the /usr/iib/xii/ .xiistart file to your home directory. 

For example, if your user name is chris, you enter 
cp /usr/lib/Xll/ .xiistart /users/chris 

♦ Note: Make sure you type a capital X when you type xi i , but not when you type 

. xiistart. 

3. Copy the /usr/lib/Xll /Sample .twmrc file to the . twmrc file in 
your home directory. 

For example, if your user name is chris, you enter 

cp /usr/lib/Xll/Sample .twmrc /users/chris/ . twmrc 
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Notice that the prefix Sample is dropped from . twmrc. 
♦ Note: Make sure you type a capital X when you type x 1 1 . 

4. Set user ownership of the . xiistart file. 

For example, if your user name is chris, you enter 
chown chris /users/chris/ .xiistart 

5. Set user ownership of the . twmrc file. 

For example, if your user name is chris, you enter 
chown chris /users/chris/ .twmrc 

The changes take effect immediately. 



Adjusting the startup file 

When you install XI 1, you create a directory called /usr/bin/xii that contains X 
commands and client applications. For A/UX to find these new files, you need to tell it where 
to look. You do this by adding the pathname of the Xll directory to the path environment 
variable. You can find the path environment variable in your shell startup script. The shell 
reads this startup script every time you start A/UK. 

If you are using the Bourne or Korn shell, your startup file is .profile. If you are using the C 
shell, your startup file is .login. Follow the steps for the type of shell you are using. Each 
person who will use Xll must perform these steps. If you are not sure which shell you are using, 
follow the procedures in both sections. 

Editing the .profile file 

Follow these steps to add the pathname of the Xll directory to the path variable 
in the . prof lie file. These steps assume that you are at a command prompt in a 
CommandShell window. 

1. Make sure you are in your home directory. 

Check your current directory by entering 

pwd 



3-20 Getting Started with X Window System for A/UX 

030-1727-A 



For example, if your user name is chris, you should beinthe/users/chris 
directory. If you are not in your home directory, enter cd /users/ username to get 
to your home directory. 

2. Use a text editor to edit your .profile file. 

3. At the first occurrence of the phrase path=, after the first quotation mark 
(") and before the list of pathnames, add 

/usr/bin/Xll : 

The first occurrence of path should now look similar to the following example: 

PATH=" /usr/bin/Xll : /bin: /usr/bin:/usr/ucb: /mac /bin: /etc : /usr 
/etc: . " 

Be sure to include the colon ( : ) to separate the pathnames. Do not include spaces 
between the various pathnames. 

4. At the second occurrence of the phrase path=, after the first quotation 
mark (") and before the list of pathnames, add 

: /usr/bin/Xll 

Notice the addition of the colon (:) before /usr. 

The second occurrence of path should now look similar to the following example: 

PATH=" :/usr/bin/Xll:/bin:/usr/bin:/usr/ucb: /mac /bin: /etc : 
/usr/etc" 

Be sure to include the colon ( : ) to separate the pathnames. Do not include spaces 
between the various pathnames. 

5. Save the file and quit the editor. 

6. Choose Logout from the Special menu. 

You return to the A/UX login dialog box. 
The changes take effect next time you log in. 

Editing the .login file 

Follow these steps to add the pathname of the XI 1 directory to the path variable 
in the .login file. These steps assume that you are at a command prompt in a 
CommandShell window. 
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1. Make sure you are in your home directory. 

Check your current directory by entering 

pwd 

For example, if your user name is chris, you should be in the /users /chr is 
directory. If you are not in your home directory, enter cd /users/ username to get 
to your home directory. 

2. Use a text editor to edit your .login file. 

3. At the first occurrence of the phrase setenv path, after the first quotation 
mark (") and before the list of pathnames, add 

/usr/bin/Xll : 

The first occurrence of the phrase setenv path should now look similar to the 
following example: 

setenv PATH "/usr/bin/Xll : /bin : /usr/bin : /usr/ucb : 
/mac/bin:/ etc:/usr/ etc: ." 

Be sure to include the colon ( : ) to separate the pathnames. Do not include spaces 
between the various pathnames. 

4. At the second occurrence of the phrase setenv path, after the first 
quotation marks (") and before the list of pathnames, add 

: /usr/bin/Xll 

Notice the addition of the colon (:) before /usr. 

The second occurrence of the phrase setenv path should now look similar to the 
following example: 

setenv PATH ": /usr/bin/Xll : /bin : /usr/bin : /usr/ucb : 
/mac /bin: /etc : /usr /etc" 

Be sure to include the colon (:) to separate the pathnames. Do not include spaces 
between the various pathnames. 

5. Save the file and quit the editor. 

6. Choose Logout from the Special menu. 

You return to the A/UX login dialog box. 
The changes take effect next time you log in. 
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starting XI 1 for the first time 

After you have installed XI 1 and set up your user account, you can start using XI 1 right away. 
Follow these steps to start XI 1 at the point of logging in to A/UX. If your screen displays the 
Finder desktop, choose Logout from the Special menu to return to the A/UX login dialog box. 

1. While in the A/UX login environment, choose Change Session Type from the 
Options menu, or press Command-S. 

The Change Session Type dialog box appears, as shown in Figure 3-10. If you installed 
XI 1 correctly, you will see Xll as one of the environment choices. 



Figure 3-10 The Change Session Type dialog box 



Name: 



Change Session Type 
Passujord 



R/UK Finder (32-bit) 
R/UK Finder (24-bit) 
Console Emulator 



O 



Cancel 



D 

[ Euery Session ] 
[[ This Session Only J 



Mil is Rpple's adaptation of the industry standard 

HI lUindoiu System for R/UK. H11 Is a pure K enuironment, 

and no Macintosh compatibility Is prouided. 



2. Select Xll by clicking it. 

3. Enter your user name in the Name text box and press Tab. 

4. Type your A/UX password in the Password text box. 
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5. Click This Session Only. 

XI 1 is set as the environment for the current session only. The Change Session Type 
dialog box disappears, and you return to the A/UK login dialog box. 

♦ Note: You can choose XI 1 as your default environment by clicking Every Session. 
Then whenever you start up A/UX and log in, XI 1 automatically starts up. 

6. Click Login or press Return. 

After a few moments, the XI 1 startup screen appears, as shown in Figure 3-11. 



Figure 3-11 The XI 1 startup screen 



"ventana" is the 
host computer's name 



xterm windows 




— Client 
applications 
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Figure 3-11 identifies tlie different parts of a typical XI 1 startup screen. In this sample screen, 
the name of the host computer is "ventana." When you start XI 1, you see the name of your 
computer in place of "ventana." 

To exit from Xll quickly, type exit in the window named "console." When you exit Xll, you 
return to the A/UX login dialog box. 



Where to go from here 

You can learn how to use Xll by reading Xll User's Guide for A/UX, which explains how to work 
with client applications, windows, pop-up menus, and other Xll features. 
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Appendix Setting Up a Network Kernel 



This Appendix describes how to use the newconf ig command to create a 
network kernel on your computer. You need a network kernel before you 
can install and use either MacX or Xll. 

If you have already configured your computer for network capabilities 
using newconf ig according to either Setting Up Accounts and Peripherals 
for A/UX or A/UX Network System Administration, you do not need to 
repeat those steps. 
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Before you begin 

when you run the newconf ig command according to the steps in the next section, you will 
need to know the following information. You can obtain it from your system administrator. 

■ host name — a word, for example, "b o i i n a s " 

■ Yellow Pages domain name — a word, for example, "ucsd" 

■ Internet address — a series of digits and periods, for example, 8 9.10.0.23 

■ Broadcast address— a series of digits and periods ending with . 2 55, for example, 

89.10.0.255 

■ netmask (optional) — a series of digits and periods, for example, 255.255.255.0 



Creating a network kernel 

Follow these steps to use newconf ig to create a network kernel on your computer. These 
steps are designed to set up a Network File System (NFS) network kernel. If you prefer a plain 
TCP/IP kernel, replace all instances of nfs with bnet. 

You should have started A/UX and logged in as the root user. 

1. On the A/UX Finder desktop, choose CommandShell from the Apple menu. 

To choose a command from a menu, you position the pointer on the menu tide in 
the menu bar and press the mouse button. While holding down the mouse button, 
drag to the command you want, and then release the mouse button. A CommandShell 
window appears with a command prompt. 

2. Enter newconf ig nfs at the command prompt. 

D If your computer has an Ethernet card, you see the messages 

newconf ig: Preparing to build a new A/UX kernel. 

Do you want this machine to be an NFS server (y or n) ? 

[default: n] 

Go to step 3. 
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D If your computer does not have an Ethernet card, the system does not prompt you for 
any networking information but displays these messages instead: 

newconfig: Building a new A/UX kernel (this may take 

awhile) 
newconfig: Adjusting kernel parameters, 
newconfig: Checking for any installation information, 
newconfig: The new configuration will take effect when the 
system is rebooted. 

Go to step 9 to restart your computer. 

3. Press Return for "no." 

♦ Note: If you want your computer to be an NFS server, type y for "yes" and press 
Return. You will see several messages in addition to the ones shown in this step. 

You see the following messages: 

newconfig: Building a new A/UX kernel (this may take 

awhile) . 
newconfig: Adjusting kernel parameters, 
newconfig: Checking for any installation information. 

Please enter a host name (it must be unique): 

4. Enter the name of your computer. 

For example, type bo Unas and press RETURN. 

You see the message 

Please enter a domain name: 

5. Enter your domain name. 

For example, type ucsd and press Return. 

♦ Note: If you do not have a Yellow Pages domain name, enter nodomain as 
a placeholder. 

You see the messages 

1 EtherNet card(s) installed. 

aeO : Please enter an Internet address: 
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6. Enter your Internet address. 

For example, type 8 9.10.0.23 and press RETURN. 

You see the message 

aeO: Please enter a Broadcast address: 

7. Enter your Broadcast address. 

For example, type 89.10.0.255 and press RETURN. 
You see the message 

aeO : Please enter a netmask (none) : 

8. If you have a netmask, enter it. 

For example, type 255.255.255.0 and press RETURN. 
If you do not have a netmask, press Return. 

You see a summary of the information that you entered, for example, 

aeO : host name is bolinas with IP address of 89.10.0.23 
broadcasting with 89.10.0.255 

newconfig: The new configuration will take effect when the 
system is rebooted. 

9. Choose Restart from the Special menu to restart your computer. 

Restarting your computer puts the new network kernel into effect. After restarting, 
you return to the A/UX login dialog box. Depending on how your A/UX system is set 
up, you may instead return to the Macintosh desktop. 

Now that you've created a network kernel, you can log back in to A/UX and continue 
with the installation procedures in either Chapter 2 or Chapter 3. 
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